package com.learn.english.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.learn.english.model.entity.KnowledgeBase;

import java.util.List;
import java.util.Map;

/**
 * 知识库管理服务接口
 */
public interface KnowledgeService extends IService<KnowledgeBase> {

    /**
     * 获取知识条目列表
     * @param params 查询参数
     * @return 知识条目列表
     */
    List<KnowledgeBase> getKnowledgeList(Map<String, Object> params);

    /**
     * 分页获取知识条目列表
     * @param params 查询参数
     * @return 包含分页数据的Map
     */
    Map<String, Object> getKnowledgeListByPage(Map<String, Object> params);

    /**
     * 根据ID获取知识条目详情
     * @param id 知识条目ID
     * @return 知识条目对象
     */
    KnowledgeBase getKnowledgeById(Long id);

    /**
     * 添加知识条目
     * @param knowledgeBase 知识条目对象
     * @return 是否添加成功
     */
    boolean addKnowledge(KnowledgeBase knowledgeBase);

    /**
     * 更新知识条目
     * @param knowledgeBase 知识条目对象
     * @return 是否更新成功
     */
    boolean updateKnowledge(KnowledgeBase knowledgeBase);

    /**
     * 删除知识条目
     * @param id 知识条目ID
     * @return 是否删除成功
     */
    boolean deleteKnowledge(Long id);

    /**
     * 批量删除知识条目
     * @param ids 知识条目ID数组
     * @return 是否删除成功
     */
    boolean batchDeleteKnowledge(List<Long> ids);
}